home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr52 / bblink16.zip / BBLINK.DOC next >
Text File  |  1993-04-16  |  21KB  |  818 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                bBLINK v1.05
  12.  
  13.                    * Linker Utility by Bullet Software *
  14.                           Clipper ver. s87 & 5.01
  15.  
  16.                          (all rights reserved)
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.          BULLET SOFTWARE
  31.          10376 E. COLONIAL DR
  32.          SUITE 110
  33.          ORLANDO,FL 32817
  34.          (407) 277-5198
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.      -----------------------[ Disclaimer ]-------------------------------
  57.      
  58.  
  59.  
  60.  
  61.       Bullet Software distributes this utility solely on an "as is"
  62.       basis and offers no warranties at all.
  63.  
  64.       Bullet Software shall not bear any liability or responsibility to
  65.       any user or entity with respect to any liability, loss or
  66.       damage caused, or alleged to be caused directly, or indirectly
  67.       by this in this product, including but not limited to interruption
  68.       of services, loss of business or anticipatory profits or consequential
  69.       damages resulting from the use or operation of any of the functions
  70.       contained in this product.
  71.  
  72.       Bullet Software makes no warranties, either expressed or implied
  73.       regarding this software product, it's merchantability and/or
  74.       it's fitness for a particular purpose. The user agrees that
  75.       Bullet Software shall not be held liable for any consequential
  76.       damages, even if Bullet Software has been advised of the possibility
  77.       of such damages.
  78.  
  79.       By using this utility you acknowledge your agreement with all of
  80.       the above conditions.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.      -----------------------[ Authorization of Use] ----------------------
  110.  
  111.      You may use bBLINK for a period of 30 days, after which time you
  112.      must either cease use or register your copy with Bullet Software.
  113.  
  114.      Registration is accomplished by sending the current REGISTRATION
  115.      and ORDER form found at the end of this file. Also, for your
  116.      convenience you will find a file named ORDER.TXT in this
  117.      compressed file that you may type:COPY ORDER.TXT > PRN and it will
  118.      print out on your printer for you. Of course you may call to order
  119.      your registered version to receive it in a more timely fashion.
  120.  
  121.      Orders will be filled only if accompanied by the current
  122.      registration fee.
  123.  
  124.      bBLINK is NOT freeware. If you believe it has value to you, then
  125.      registration is in order.
  126.  
  127.      Bulletin board services and other such services may charge a fee
  128.      no greater than disk and transfer charges for this product.
  129.      This is in NO WAY TO BE CONSIDERED AS payment for this product.
  130.      This product can ONLY be purchased from Bullet Software, any fee
  131.      you may have been charged by ANY ENTITY other than Bullet Software
  132.      for this product is not considered valid by Bullet Software or
  133.      the author of the this product.
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.   
  162.  
  163.      -----------------------[ What is bBLINK ]-------------------------------
  164.  
  165.                 Zip file contents: bBLINK.EXE
  166.                                    bBLINK.DOC
  167.                                    ORDER.TXT
  168.                                    DISCLAIM.TXT
  169.  
  170.  
  171.                        Copyright : Bullet Software
  172.                                    Orlando,FL
  173.  
  174.  
  175.         Purpose : Utility to create compile & link  files quick and easy.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.    
  215.  
  216.  
  217.          ----------------------[ What is Required ]---------------------
  218.  
  219.  
  220.                          Clipper.exe   ver 5.01 or s87
  221.                          Blinker.exe   ver 1.50 or greater
  222.                          make.exe      any generic make utility
  223.                                        (clipper compatible)
  224.  
  225.  
  226.  
  227.  
  228.          This utility is to be used with BLINKER(tm) linker by
  229.          Assembler Manufacturers INC. this utility is designed
  230.          to aid users who are beginning to use BLINKER as well as
  231.          seasoned professionals.
  232.  
  233.          Bullet Software is in NO WAY CONNECTED or INVOLVED WITH
  234.          the above mentioned company.
  235.  
  236.          Bullet Software and Robert Morgan are the sole owner of the
  237.          source code and rights to this program.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.     
  272.  
  273.  
  274.      ---------------[ A Few Benefits of using BLINKER ]-------------------
  275.  
  276.         NOTE:
  277.         These comments are from the Blinker documentation dated 1991
  278.         and are not to be considered as current.
  279.  
  280.         BLINKER is a dynamic overlay linker which allows the
  281.         Clipper developer to easily and effectively overcome the 640KB
  282.         limit imposed by DOS on the personal computer.
  283.  
  284.         Instead of having to structure an application into overlays
  285.         which are mutually exclusive and therefore may use the same
  286.         area in memory at run time, the developer simply specifies
  287.         which procedures or functions may be overlaid and leaves the
  288.         rest to the BLINKER overlay manager.
  289.  
  290.         BLINKER performs the link phase of an application's compile and
  291.         link cycle, creating overlay units for the dynamic overlay
  292.         manager and linking the application two to four times as fast
  293.         as MS LINK (in itself at least three times as fast as PLINK86plus
  294.         and .RTLINK). At run time this results in a simpler, more compact
  295.         program which uses less memory much more efficiently than with
  296.         traditional linkers.
  297.  
  298.         BLINKER may also be used to prepare a demonstration copy of an
  299.         application at link time without modifying the application code
  300.         in any way. The demonstration program may be restricted either
  301.         by the number of procedure or function calls, by the number of
  302.         minutes of execution time, or by an expiration date after which
  303.         the program will not run.
  304.  
  305.         BLINKER provides profiling facilities allowing a user defined
  306.         Clipper procedure to be called each time any overlaid Clipper
  307.         procedure is called, without modification of the application
  308.         source code. This allows the developer to monitor an application
  309.         while it is running and record information such as how many
  310.         times each overlay was called and how many times it was loaded
  311.         from disk.
  312.  
  313.         Assembler Manufacturers INC. may be contacted at:
  314.  
  315.         3304 Nuttree Woods Drive
  316.         Midlothian, VA 23112
  317.         Tel. (804) 744-LINK
  318.         Fax  (804) 744-3527
  319.         BBS  (804) 744-2583
  320.         CIS   75140,1173
  321.      
  322.  
  323.  
  324.  
  325.  
  326.  
  327.         Foot note: 02/13/92
  328.  
  329.         According to messages left on the BLINKER bbs there is to be a
  330.         release of Blinker version 2.0 very soon. It is also expected
  331.         that according to their usual professional standard of backward
  332.         compatibility Assembler Manufacturers INC. will allow you to
  333.         continue to use the same style of .lnk and .mak files for linking.
  334.         However, should this not be the case, we will immediately begin
  335.         work on producing a compatible version of bBLINK. We don't foresee
  336.         this to be valid, but, bBLINK will be compatible whatever the
  337.         case.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.       
  378.  
  379.  
  380.  
  381.         ------------------------[ Using bBLINK ]-------------------------
  382.  
  383.         1.  Copy all of your program files (.prg's) into an EMPTY
  384.             work directory.  (PRGS ONLY no other files!)
  385.  
  386.         2.  Copy bBLINK to a directory that DOS always has access to.
  387.             (Be sure bBLINK IS IN YOUR DOS PATH!)
  388.  
  389.         3.  Change to the work directory that contains your PRGS ONLY that you
  390.             want to create incremental linking files for and type bBLINK.
  391.             ┌───────────────────────────────────────────────────────────────┐
  392.             │3a.      ┌────────────────────────────────────────┐            │
  393.             │         │    *  (FIRST TIME RUNNING bBLINK) *    │            │
  394.             │         └────────────────────────────────────────┘            │
  395.             │                                                               │
  396.             │  Enter the information for the questions as you are prompted. │
  397.             │                                                               │
  398.             │  (This info will be saved.)                                   │
  399.             └───────────────────────────────────────────────────────────────┘
  400.  
  401.             The first run of bBLINK on your system will activate the setup
  402.             module. The questions are few, and direct to the point. I will
  403.             not go into the meaning of the terms used, such as path etc.,
  404.             if you don't understand these questions you should STOP NOW and
  405.             find someone who does. Have them help you do the install.
  406.  
  407.             The only tip you should need is when entering a path DO NOT
  408.             include any file names these are ONLY PATHS.
  409.  
  410.             bBLINK knows the name of the files it is looking for or you
  411.             will be given this option later.
  412.  
  413.             NOTE:
  414.  
  415.             The NON-REGISTERED version will have a registration screen
  416.             each time bBLINK is started. The registered version will not
  417.             have any introductory message whatsoever.
  418.  
  419.  
  420.         4.  Enter your MAIN or (TOP) file name.
  421.  
  422.             This information will be saved upon exit.
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.        
  432.  
  433.  
  434.  
  435.  
  436.         5.  Select your libraries.
  437.  
  438.             (press enter on highlighted library)
  439.  
  440.             Select where to put the library in relation to the .LNK file.
  441.  
  442.             a. SEARCH
  443.             b. ROOT
  444.             c. ALLOCATE
  445.             d. SECONDARY
  446.  
  447.             Consult your BLINKER documentation for the meaning and use of
  448.             these terms. (we will not reinvent the wheel by trying to
  449.             explain these) Although a good tip is to have the NORTON
  450.             GUIDE that came with your BLINKER linker running in the back-
  451.             ground so you may refer to the meaning of these, and other
  452.             terms.
  453.  
  454.  
  455.             Once you have selected a library you will see the current
  456.             status position of the selected library in the .LNK file
  457.             in one of the boxes in the upper right. You will also notice
  458.             if you have a color monitor, they are of different colors.
  459.             This is based on their order of importance regarding memory
  460.             use and link priority.
  461.  
  462.             If you have a NON REGISTERED version you will be restricted
  463.             to only one directory path for your library choices and only
  464.             three windows for library listings.
  465.  
  466.             The registered version allows up to 4 directory paths for .LIB
  467.             files and has a separate window for the SEARCH allocation, (and
  468.             that's not the only differences).
  469.  
  470.  
  471.  
  472.  
  473.  
  474.         6.  Press the INSERT KEY to select THE BLINKER OPTIONS to add to your
  475.             .LNK file.
  476.  
  477.             (press enter on the highlighted option)
  478.  
  479.             If the option you have chosen requires more information from you,
  480.             another widow will pop up asking for your parameters for that
  481.             particular function (refer to your .ng for this).
  482.  
  483.             If the option you have chosen is a simple command
  484.             'ie:BLINKER MESSAGE NOBLINK' then you will just see the window
  485.             BLINK at you (forgive the pun). Here again there is a distinct
  486.             difference between the REGISTERED and NON REGISTERED versions.
  487.  
  488.  
  489.             (continued)
  490.             In the NON REGISTERED VERSION there is no distinction made between
  491.             selected and un-selected options you just have to remember where
  492.             you are and what you have chosen. Also, there is no editor to
  493.             edit your chosen functions. (only an inconvenience) but having
  494.             the ability to edit is great to have.
  495.  
  496.  
  497.  
  498.         7. Escape when done.
  499.  
  500.             (file creation)
  501.  
  502.             After you have entered all of your options for libraries and
  503.             blinker commands. You are ready to create 3 files which will
  504.             be used for compiling and linking.
  505.  
  506.             1. BL?.BAT
  507.             2. BLINKMAK.
  508.             3. BLINK.LNK
  509.  
  510.             If you have these files from a previous run of this program
  511.             and you wish to keep them for some reason you must rename
  512.             them to some other name because they will be over written
  513.             without any warning.
  514.  
  515.             To quit and create your new .bat, .lnk and .mak files
  516.             simply hit escape.  You will see a message indicating these
  517.             files have been created, the program then exits to DOS.
  518.  
  519.             Before exiting you will notice a message indicating that you
  520.             should EXECUTE a specific file name, the file name will be
  521.             'BL?.BAT'. Where '?' is the first letter of your top file.
  522.  
  523.             Let's say your top file name is TEST.prg, that means the name
  524.             of your batch file would be 'BLT.BAT' because the letter 'T'
  525.             is the first letter in your top file name.
  526.  
  527.             The reason for the long explanation is so you can determine
  528.             in advance the name of your starting batch file in the event
  529.             you already have a batch file by that name that you wish to
  530.             keep. This is the only file that will have a different name
  531.             for each program you wish to compile.
  532.  
  533.         8.  Compiling and Linking
  534.  
  535.             (executing the starting batch file)
  536.  
  537.             To compile and link all of your modules just type the name
  538.             of your starting batch file and hit enter. If all is well
  539.             your program compiles and links as it should. If there are
  540.             errors in the programming code of course you will see the
  541.             errors and correct them.
  542.  
  543.  
  544.         
  545.           ----------------------[ A Word on Linking ]------------------
  546.  
  547.  
  548.           There are several ways to compile and link .prg files. The use
  549.           of .clp files, batch files and just a plain old command line
  550.           prompt. Which of these methods you use is entirely up to the
  551.           programmer although no attempt of supporting .clp files is
  552.           in this program they do have their place however.
  553.  
  554.           We have found that the granular approach is much more effective
  555.           for our style of professional development and need for individual
  556.           control of each program module. It lends itself to extremely
  557.           easy maintenance of large programs, procedures and functions.
  558.  
  559.           The greater level of granularity is worth the small price of
  560.           learning how to make it work for you. A program that has
  561.           30 - 40 individual functions is much easier to service and
  562.           debug if you are using the granular approach, also some word
  563.           processors complain if a text file is too large, or memory
  564.           starts getting too low to do anything.
  565.  
  566.           Portability of your functions & procedures to other programs
  567.           and libraries is greatly enhanced because you can put your
  568.           cursor on it immediately rather than browsing through hundreds
  569.           of lines of source code and comments.
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.           -------------------------[ Modifications ]---------------------
  600.  
  601.         1.  Changing the setup
  602.  
  603.             Should you need to change your original parameters for paths
  604.             to your libraries, objs etc. you can re-enter the setup
  605.             module by typing the command line :bBLINK /s
  606.  
  607.  
  608.         2.  File naming conventions
  609.  
  610.             You may want to rename bBLINK to something less cumbersome,
  611.             like BLM.EXE or B1.EXE feel free to do so. But, DO NOT append
  612.             or change any of the files within the bBLINK15 compressed file.
  613.  
  614.         3.  Created files (.lnk .bat *.)
  615.  
  616.             Browse the .LNK file, there are comments through out to guide
  617.             you through the logic. This will help you to grasp the command
  618.             format and style that will get a first time BLINKER user up and
  619.             running quickly.
  620.  
  621.  
  622.  
  623.             (External files)
  624.  
  625.             Each .lnk file you produce will have 2 lines included for your
  626.             ERRORSYS.OBJ and DEBUG.OBJ.
  627.  
  628.             You will notice that the debug.obj and errorsys.obj have been
  629.             commented out. This is clearly so that you have the option of
  630.             including them in your final .EXE. If you want them in the
  631.             final product then just remove the '#' from in front of them.
  632.             These are used by Clipper Summer 87. Clipper 5.01 uses it's
  633.             own interactive CLD.exe but you can add your own special
  634.             debugging file in every program if you wish to use in conjunction
  635.             with CLD.exe.
  636.  
  637.  
  638.             Even if you only have 3 or 4 modules in your program bBLINK will
  639.             save you hours of typing over a years time.
  640.   
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.             --------------------[ Registered Features]----------------------
  653.  
  654.             A few advantages of the registered version of bBLINK are as
  655.             follows:
  656.  
  657.             1.  Multiple data paths a the press of a key.
  658.  
  659.             2.  Script file editing and viewing on the fly.
  660.  
  661.             3.  Startup file creation options.
  662.  
  663.             4.  Unrestricted use of all functions and commands.
  664.  
  665.             5.  On-line tech support.
  666.  
  667.             6.  F1 key instant help.
  668.  
  669.             7.  Multiple configuration files (selectable).
  670.  
  671.             8.  Free upgrades on-line (current versions).
  672.  
  673.             9.  Discounts on other Bullet Software products.
  674.  
  675.            10.  Backward compatibility.
  676.  
  677.    
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.             -----------------------[ 2 Programmers ]------------------------
  706.  
  707.  
  708.             pgmr1. Why should I use bBLINK?
  709.             pgmr2. Accomplish in seconds what it takes several minutes even
  710.                    hours by hand, and with high tech accuracy.
  711.  
  712.             pgmr1. I have done it for years myself why change?
  713.             pgmr2. You won't have all that redundant typing.
  714.  
  715.             pgmr1. Gosh you are right, thanks
  716.  
  717.             pgmr2. Your welcome
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.           Note: the following prices are subject to change without notice
  758.          --------------------[ORDER REGISTRATION]-------------------
  759.                bBLINK Linker Utility Registration Order Form
  760.                              Version 1.05
  761.  
  762. Please send the following:
  763.  
  764. [ ] Copies bBLINK Linker Utility      @$39.00 ________ ea.
  765.  
  766.            Shipping and Handling       $ 3.50 ________
  767.  
  768.                         Total                 ________
  769.  
  770. Method of payment (circle one):
  771.  
  772. Money Ord.  Check   Visa   MasterCard   Amount Enclosed $_______
  773.  
  774.     Phone Orders welcome. (407) 277-5198
  775.  
  776. Name_____________________________               Company ____________________
  777.  
  778. Address ___________________________               City  ____________________
  779.  
  780. State   _________  Zip ____________               Country __________________
  781.  
  782. Phone (   )____ _______
  783.  
  784. Card Number ________________________               Expiration Date _________
  785.  
  786. Signature   __________________________________________________
  787.  
  788. Name on card  ________________________________________________
  789.  
  790.             Make Checks or Money Orders Payable to: Bullet Software
  791.  
  792.  
  793.  
  794.             Where did you receive your copy of the software you are
  795.             registering?
  796.  
  797.             _____________________________________________________________
  798.  
  799.             Comments:
  800.  
  801.             ______________________________________________________________
  802.  
  803.             ______________________________________________________________
  804.  
  805.             ______________________________________________________________
  806.  
  807.                                        Mail to:
  808.  
  809.                                  Bullet Software
  810.                                  10376 E. Colonial Drive
  811.                                  Suite 110
  812.                                  Orlando,FL 32817
  813.  
  814.  
  815.  
  816.  
  817.  
  818.